创建 Settle Account 对象

你可以为一个用户创建一个用户结算账户，每个用户在一个渠道下最多支持创建一个用户结算账户。

请求参数描述
APP_ID required string对应 app 对象的 id，该参数仅需要填写在请求地址内，查看 如何获取App ID。
USER_ID required string用户 ID ，64 位以内，首字母必须是英文、数字或者下划线，该参数仅需要填写在请求地址内。
channel required string结算账号渠道名称，目前支持：alipay（支付宝）、wx（微信 App）、wx_pub（微信 JSAPI）、wx_lite（微信小程序）、bank_account（银行卡）。
recipient required object结算账号接收者信息，见下方各渠道 recipient 参数说明 。

recipient 参数说明

alipay 支付宝账户
参数描述
account required string接收者支付宝账号。
name required string接收者姓名。
type required string转账类型，分为两种：b2c：企业向个人付款,b2b：企业向企业付款。不传时默认为b2c类型。
account_type optional string收款方账户类型。默认值："ALIPAY_LOGONID"。ALIPAY_USERID：支付宝账号对应的支付宝唯一用户号，以 2088 开头的 16 位纯数字组成；ALIPAY_LOGONID：支付宝登录号，支持邮箱和手机号格式。

wx、wx_pub、wx_lite 微信账户
参数描述
account required string接收者 open_id。点此参考如何获取open_id。
name optional string收款人姓名。当该参数为空，则不校验收款人姓名。
force_check optional boolean是否强制校验收款人姓名。仅当 name 参数不为空时该参数生效。
type optional string转账类型。仅支持 b2c：企业向个人付款。默认值为b2c。

bank_account 银行卡账户
参数描述
account required string接收者银行账号/卡号。
name required string接收者银行开户名。
type required string转账类型。b2c：企业向个人付款，b2b：企业向企业付款。
open_bank_code required string开户银行编号（针对 chanpay / allinpay / unionpay 渠道使用），请根据渠道的不同参考 银联电子代付银行编号说明 、通联代付银行编号说明 或 畅捷代付银行编号说明。
open_bank optional string开户银行名称（针对 unionpay 渠道使用）。
card_type optional int银行卡号类型，0：银行卡；1：存折；2：信用卡；3：准贷记卡；4：其他。（jdpay 不支持 1。chanpay 不支持 1、3、4）
sub_bank conditional string开户支行名称，1~80位（针对 allinpay / unionpay 渠道使用）。若使用 allinpay 渠道且 type 为 b2b，则此参数必填，详情请下载 支付行号 。
sub_bank_code conditional string支付行号（仅针对 allinpay 渠道使用），1~12位，且在 type 为 b2b 时此参数必填，详情请下载 支付行号 。
prov conditional string开户银行所在省份，（针对 allinpay / unionpay / chanpay 渠道使用）。若使用 allinpay、chanpay 渠道且 type 为 b2b，则此参数必填。allinpay渠道此参数要求：不带 “省” 或 “自治区”，需填写成：广东、广西、内蒙古等，详情请参考 中国邮政区号表 内的「省洲名称」列的内容填写。chanpay渠道此参数要求：参考 畅捷代付省市列表 内的「prov」列的内容填写。
city conditional string开户银行所在城市，（针对 allinpay / unionpay / chanpay 渠道使用）。若使用 allinpay、chanpay 渠道且 type 为 b2b，则此参数必填。allinpay渠道此参数要求：不带 “市”，需填写成：广州、南宁等。如果是直辖市，则填区，如北京（市）朝阳（区），详情请参考 中国邮政区号表 内的「地区名称」列的内容填写。chanpay渠道此参数要求：参考 畅捷代付省市列表 内的「city」列的内容填写。

返回

返回一个 settle_account 对象，或者返回一个错误，详见 错误。

定义

POST https://api.pingxx.com/v1/apps/{APP_ID}/users/{USER_ID}/settle_accounts
 
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/users/user_test_003/settle_accounts \
-H "Pingplusplus-Signature: SIGNATURE" \
-H "Pingplusplus-Request-Timestamp: 1475029155" \
-H "Content-Type: application/json" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
-d '{
  "channel": "alipay",
  "recipient": {
    "account": "account01@gmail.com",
    "name": "李雷",
    "type": "b2c"
  }
}'
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
  "id": "320217022818035400000601",
  "object": "settle_account",
  "created": 1488276234,
  "livemode": true,
  "channel": "alipay",
  "recipient": {
    "account": "a***@gmail.com",
    "name": "***雷",
    "type": "b2c"
  }
}